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This paper represents the beginning of a •helpful hints on how to 
do your job's document* Some of the areas discussed are still 
incomplete. I will be periodically adding information to the 
document. If you have any qustions or suggestions* please see 
Tom HcGee. Appendix A lists background documents and how to 
obtain them. 

U2ila£e._ai££ox¥. 

Date Changes 

2/3/80 Section 3.0 revised 

2/12/80 Appendix A Section 3.3 corrected 

2/13/80 Section 1.0 revised 

9/11/30 Section 3.5.2.3 revised* Section 3.5.2.8.4 added 

12/22/80 Revisions for NOS/VE Phase C 
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1.0 DUAL STATE NOS/VE DEA9START 



1.0 aUAL.SIAI£.tiaSZY£-a£Att£IASI 



1.1 AlZfl-aaS.aEAQSUBLl 

o The system is configured to run with three FMD units (41* 42 
and 43K Mo 844 drives are needed. 

o Set the D/S panel to deadstart from the primary system disk. 

o Push 0/S button 

o Select "Q M display 

o Sel ect W H H displ ay 

o Enter C1»10000 

o Enter (OR) 

Enter date/ ti me 

tfait for deadstart to complete 

Notes The deadstart tape which matches this A170 NOS system is 
found in the tape cabinet back by the curtains* where all the 
other Integration tapes are kept* labeled DUAL6M* 

1.2 CUB&EMI-aUAL-SIAIE-CQliEIfiliaAIIflli 

o FMD Unit 43 

This unit contains the following: 

- A170 NOS (Build 4 level)* CTI> CMSE* EI binaries, NOS 
deadstart f i I es 

Files associated with user number LIBRARY 
Files associated with user number SES 

- Files associated with DEVI* REL1* INT1* 

o FHO Unit 41 

- A170 NQS (Build 6 level)* CTI* MSU EI binaries* NOS 
deads tar t f i I e 
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1.0 DUAL STATE N0S/VE- D€ADSTART 

1.2 CURRENT DUAL STATE CONFIGURATION 



This is a scratch unit 

Fno Unit kZ 

This unit contains the following* 

NQS/VE Development Area PL's and Member PL's 
NOS/VE Deadstart Files to be tested (saved in individual 
user's catalogs) 
— Files associated with user number INT2 



1 . 3 aUAL.5IAI£i.tlQS-Q£E&AIiaii 

1) The convention used for creating user numbers on NQS/VE is 
as foil ows: 

o Your user number wail be your initials* 

o Your password will be these 3 letters followed by the 

letter f x'. 
o You must see CONSOURCE {R.K. Cooper - x3092) to be 

assigned a user index 

User numbers are created by executing the program "HQDVAL** as 
f ol I owss 

o Type "X.MODVAL". 

o Type n K$m* H where m is the MODVAL control point 

o Type ,, K*C#uuu. w where uuu * your user number. Note that 

the *•<••" stays on the screen. 
o Type M K*PW*uuuX» FUI*n." where n * your user index 
o Set all other parameters to their maximum values* Do a 

"+ M to see next page - there are 3 pages associated with a 

user number. 
o Type "K.ENID.** to end creation of that user number. 

Another user number may now be created* 
o Type "K.END." again to exit HODVAL* 

2) PF dumping and loading 

You may use "SES.DUMPPF" on SN/101 to dump your permanent 
fies to tape* and then load them onto your user number on 
A170 MOS using "SES .LQADPF"* Documentation on how to use 
these SE-S procedure and what their parameters are is included 
in the SE-S "User's Guide* or they can be obtained by typings 

"SES.HSLP.DUMPPF" and "SES .HELP.LOADPF ", 
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1.0 DUAL STATE MQS/VE DEADSTART 
1.4 NOS/VE DEADSTART 



1.4 namE-&£-Aflm&i 



o The following file must be available in your catalog on the 
52* 

TPXXXK contains a NOS/VE deadstart image. This must be a copy 
of the dual state deadstart images available from the link 
procedures. 

CIMAGE* PPIMAGE* RGIHAGE are "fast" files* which are built 
from TPXXXK the first time you deadstart NOS/VE. These files 
are then used on subsequent deadstart attempts. Before a new 
TPXXXK can be used* these "fast** files must be purged off your 
user nunber. 

o Hount the disk labeled "DAHL-Large sector* on 844 unit 
(other disks will not work). The default disk driver for 
build M is the MQS/VE driver. 

o Type the foil owing: 

X.OIS. 

USER»scat* scatx. where scat * INT1 or INT2 

CALL, SYEDNVE. 

DROP. 

o Bring up dual state* 

X.UPfiYVE (CAT*mycat> 0EVl»scat) 

where mycat * user catalog (as before) 

scat s system ctalog - INT2 or INT1 

o The UPMYVE job will display the following: 

REQUEST *<* DISPLAY on the 8 display 

Type K#n* where n is the control point number of the UPMYVE 
Job* 



i . 5 aomf-iEiaiMiiQii 



o Bringing down dual states 

K.*BYEVE. 
K.*ENDR'JN 
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1,0 DUAL STATE NOS/VE DEAOSTART 
1*6 8RINS UP C170 REMOTE HOST 



1.6 a&iiifi-ii£-£i2fl,&Eafli£.uasii 

Type 

TAFMVE^ 

Control paint tvio must be free or rolloutable (i»e», NAM should 
not be there), This also brings up PASSON and the ML I subsystem 
control points* 

If either Cor both) CRHF170 or PASSON abort or are dropped by the 
operator* they can be brought up by entering* 

X.IRHF170* 

or 

X. PASSON* 

if TAF is still at control point two* If TAF has aborted* then 
the TAFNtfE* command must be used* 



1.7 aainfijiE-aiflflL&EiiQit-Hasi 



Type 

K,n* where n is the UPMYVE control point number* 
K. EXECUTE*.. ,,RHP$INPUT,TASK..NAME»A. 
K* EXECUTE.. ,,,RHP$0UT PUT, TASK. NAME* B* 

Notes To enter $ at the console, type/4 
To enter _ at the console* type/0 



1*7*1 ROUTE AN INPUT FILE FROM C170 TO C180 

Through the system console* enter* 

Type 

X*DIS* 

USER, A, 8* 

GET, fi I en am e, a here filename 

identifies the input file to 

be routed* 
ROUTE, fi I ename,DC*LP,FC»RH. 

If you are running from an interactive terminal, enter* 
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1.0 DUAL STATE NOS/VE DEAOSTART 

1.7.1 ROUTE AN INPUT FILE FROM C170 TO C180 



SET* f i I en ane. 

ROUT£.»f i iename,DC»LP#FC*RH. 

The input file which is sent to the 180 must be in 6/12 ASCII 
Cor display code subset). The job file must be a single 
partition 170 record containing NOS/VE commands. Hulti partition 
input files are not yet supported by NOS/VE so 170 data files 
used by the program must be obtained through the NOS/VE permanent 
file GET command. The last command of the job file must be 
JHEXIT in order to cause the job to terminate properly. 

1.7.1.1 &nut£_A_£tiat_£iifl-££ai_£lfla_ia-d2Q 

At NOS/VE job termination the job log (dayfile) will be 
automatically returned to the 170. The job log will be appended 
to the NOS/VE output file OUTPUT. NOS/VE print files must be 
written by 8AM as 8/8 ASCII RT*W. Print files will be converted 
from 3/8 ASCII RT*W to Display Code {64 character set - upper 
case only) when they are sent to the 170. Support for ASCII 
print files (8/12 ASCII) will be added at a later build. All 
NOS/VE output files will appear in the 170 output queue <N0S H*0 
display) with the name IRHFxxx as a banner. In order to route a 
NOS/VE print file to the 170* the following command must be 
contained in the 180 job file or be entered from the system 
console via the K displays 

JMRQUTE* jobname>f i 1 ename* PR#REH0TE 

jobname - name that the print file will have in the 180 
output queue. 

filename - name of the local 180 file created by BAH that is 
to be printed. 

PR - specifies that the file is a print file (must always be 
PR). 

REMOTE — name of the 180 family for the print file (must 

always be REMOTE). The NOS command language must be in 

HCS mode (HCS command) in order to enter the 3MR0UTE 
command. 

Example of JflROUTE commands 

J1R0UTE,LISTING>LINKMAP>PR>REM0TE. 

On the C170 side* the printer must be physically and 
logically on. To logically turn the printer on* under 
DSO enters 
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1,0 DUAL STATE NQS/VE DEADSTART 

1*7*1*1 Route A Print File From C180 to C170 



0M32* 
F3RH32.n. 

1.M.2 LI!4!i-US£&-£aaaaod 



In order to access C170 permanent files from a C180 job* the 
NtiS/VE job must issue a LINK. USER command. The LINK^USER command 
specifies the user identification on the 170 under which C170 
permanent files will be accessed* 

The following must be done to enter the LINK. USER command? 

LIU»US*(user» f ami ly) » P A=pass wor d* A»account* PR»project* 

The LIU Cor LINK. USER) command specifies the NOS user* family 
and password parameters which are used by IRHF170 to create 170 
jobs which access C170 permanent files* AM LINK.USER parameters 
are specified with keywords* The account and project parameters 
are not requied and not utilized* 

US tor USER) - This parameter specifies the NOS user number 
(catalog) and family in which the 170 permanent files reside* 
•user 1 will be the first parameter on the 170 job*s USER card and 
•family 1 will be the third parameter* Currently the only family 
on the S2 Dual State system is called NVE* 

PA (or PASSWORD) This parameter specifies the password that 
is used to login to the user number* •password* will be 
the second parameter on the 170 job*s USER card* 

A or (ACCOUNT) This parameter specifies the account number 
(charge number) for the 170 job* It will be the first 
parameter on the 170 job»s CHARGE card* 

PR or (PROJECT) This parameter specifies the project number 
for the 170 job* It will be the second parameter on the 
170 job's CHARGE card* 

Notes When running on the Simulator* the LINK. USER command 
is not required to use the GET and REPLACE commands* 

Example of LINK. USER commands 

LIU.US*(F<AB,NVE).PA*FABX,A*7136*PR»7 3£08802. 
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1.0 DUAL STATEMOS/VE 0EA0START 

1.7.1.3 Get A 170 Permanent File From 180 



1.7,1.3 ast^4-122-E£LiaasQt-£ila-££ai-.13a 

The GET command obtains a copy of a permanent file residing on 
the 170. The 170 permanent file can be either a direct or an 
Indirect access permanent file* The NOS/VE command processor 
must be in HCS mode (HCS command issued) in order to use the GET 
command. AH parameters on the GET command are positional. Only 
the Mfn* parameter is required* A LINK_US£R command must be 
issued {for the 170 family on- which the permanent file resides) 
prior to issuing the GET command. The format of the GET command 
i ss 

G£T«ifn.pfn»pw.un.fm*cd. 

I f n (local file name) - This is the name of the local NOS/VE 
file to which the 170 permanent file will be transferred. 

pfn (permanent file name) — ■ This is the name of the 170 
permanent file that is to be accessed. If this parameter is 
omitted then Hfn* will be used for the 170 permanent file 
name* 

pw (password) - This is the password that will be used to 
access the 170 permanent file if a password is required to 
access the file on the 170. 

un (user name) - This is the user name (alternate catalog) 
on which the 170 permanent file resides. 

fm (family) - This is the family on which the 170 permanent 
file resides. Currently the only 170 family on the S2 Dual 
State system is NVE. 

ca (conversion alternatives) - This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 170 to 180. If this parameter is omitted 
then a default of 360 will be assumed. Values for this 
parameter ares 

860! Basi c Bi ary 

The full 60 bits of each 170 word are transferred to the 
lower 60 bits of each 64 bit 180 word. The upper 4 bits 
of each 64 bit 180 word are set to 0. The file is 
written to 180 using BAM with Slock Type « System 
(Unblocked) and Record Type « Undefined (RT«U) so no 
control information is inserted in the file. The 170 
logical record structure is dropped (i.e.* EQRs are 
deleted causing the logical records to be packed 
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1.0 DUAL STATE NOS/VE DEADSTART 

1*7.1*3 Get A 170 Permanent File From 180 



together. 

856i C180 Bi nary 

The lower 56 bits (7 8 bit bytes) of each 170 word are 
packed into contiguous 8 bit bytes on the 180 <i*e.» 7 8 
bit bytes from the first 170 word and 1 8 bit byte from 
the second 170 word go into the first 180 word etc*)* 
The 170 logical record structure (EORs) are dropped. 
The way that the 180 fife which was transferred from 170 
is accessed should correspond to the method used to 
create it on the 180 originally (assuming that the file 
originated on the 180). 

A6: 6/12 ASCII 

A170 6/12 ASCII character files <used by XEDIT and most 
SES utilities) are converted to 180 8/3 ASCII with Block 
Type * System (Unblocked) and Record Type * Variable 
(RT=W). The 170 logical record structure EORs are 
dropped. 

A3? 8/12 ASCII 

170 8/12 ASCII character files are converted to 180 8/8 
ASCII with Slock Type » System (Unblocked) and Record 
Type » Variable (RT*W). The 170 logical record 
structure (EORs) are dropped. 

06^J Display Code 64 Character Set 

170 Display Code character files are converted to upper 
case 180 8/8 ASCII with Block Type * System (Unblocked) 
and Record Type * Variable (RT»W). The 170 logical 
record structure EORs are dropped* 

Example of GET commands 

IIU,US»(F»AB,NVE).PA»FABX,A»7136,PR*73E08802. 
GET, TEXT, TEXT612*,,NVE,A6. 

Notes When the SET command is used on the Simulator, the 
file specified by the •pfn 1 parameter must be a 
170 file which is local to the simulator job. 

1.7.1.4 S££L Aa£«A.I2a.^r.3iiaaaai.£ila.£r.flffl-Ua 

The REPLACE command transfers a copy of a 180 local file to a 
permanent file on the 170. If a permanent file of the same name 
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1*7.1.4 REPLACE A 170 Permanent File From 180 
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REPLACE* lfn*pfn»pw*un« fm* ca. 

Ifn (local file name) — This is the name 
file which will be transferred to a 

the 170. 



of the local NOS/VE 
permanent file on 



Pfn (permanent file name) - This is the name of the 170 

permanent file that is to be created or replaced. If 

this parameter is omitted then ' Ifn' will be used for 
the 170 permanent file name. 

pw (password) - This is the password that will be associated 
with a newly created direct access file or which is used 
to gain access to an already existing direct or Indirect 
access permanent file. 

un (user name) - This is the user name (catalog) on which an 
existing 170 direct or indirect access file resides. 
This parameter is illegal if the file does not exist. 

fm (family) - This is the family on which the 170 permanent 
file is to reside. Currently the only 170 family on the 
S2 Dual State system is NV£. 

ca (converion alternatives) - This parameter specifies the 



type of conversion that is performed 
files transferred from 180 to 170. If 
omitted then a default of 860 will be 
for this parameter are: 



by the IRHF on 
this parameter is 
assumed. Values 



860: 8asi c Bi nary 

The lower 60 bits of each 64 bit 180 word are 
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1.7.1.4 REPLACE A 170 Permanent File From 180 



transferred to the full 60 bits of each 170 word. The 
upper 4 bits of each 64 bit 180 word are discarded. The 
130 file which is to be transferred should be written by 
8AM with Slock Type ■ System {Unblocked) and Record Type 
* Undefind <RT*U). The file is transferred to the 170 
as a single logical record {i.e. files with multiple 
€3Rs cannot be created on the 170 from the 180). 

856* :i80 Binary 

Groups of 7 contiguous 8 bit bytes from the 180 will be 
transferred to the lower 56 bits of each 170 word {i.e. 
the first 7 8 bit bytes from the first 180 word go to 
the lower 56 bits of the first 170 word* the 8th 8 bit 
byte of the first 180 word and the first 6 3 bit bytes 
from the second 180 word go to the lower 56 bits of the 
second 170 word etc.). The way that the 180 file to be 
transferred is created does not matter because the 
entire structure of the 180 file is preserved on the 
170. The file is transferred to the 170 as a single 
logical record. 

A6J 6/12 ASCII 

A 180 8/8 ASCII character file with Slock Type * System 
{Jnblocked) and Record Type * Variable {RT«W) is 
converted to a 170 6/12 ASCII file {used by XEDIT and 
most S£S utilities). The file is transferred to the 170 
as a single logical record. 

A8: 8/12 ASCII 

A 180 8/3 ASCII character file with Block Type * System 
{Unblocked) and Record Type * Variable {RT»W) is 
converted to a 170 8/12 ASCII file. The 170 file can be 
routed directly to the printer with the 170 ROUTE 
command with the £C*A9 parameter. The file is 
transferred to the 170 as a single logical record. 

064? Display Code 64 Character Set 

A 180 8/8 ASCII character file with Slock Type » System 
{Unblocked) and Record Type » Variable {RT»W) is 
converted to a 170 Display Code file with lower case 
characters mapped to upper case. ASCII special 
characters that do not have a Display Code equivalent 
are converted to Display Code blanks. The file is 
transferred to the 170 as a single logical record. 

Example of REPLACE commands 
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1.7.1.4 REPLACE A 170 Permanent File From 180 



LIU,US»{FA8*NVE)#PA*FABX.A*7136>PR«73£08802. 
R£PLACE.1YFILE.FILE856»#.NV£.3 56. 

Note: Irfhen the REPLACE command is used on the Simulator* the 
file specified by the *pfn f parameter will become a 
170 file which is local to the simulator job* 

1.7.1,5 £*aaai£-iaJ23.-S£a£££sa£iaa^^ 

General Motes 

o The HCS and SCL commands have been deleted, 

o Comment capability within command line is not currently 

avail able 
o HCS comment line format <starts with single quote) not SCL 

compati b I e 
o The 860 conversion parameter on the SET command is utilized to 

indicate that the A170 file Is to be transferred to NOS/VE 

without conversion 
o The NQS/VE job command stream must use NOS 6/12 ASCII Cor 

display code subset) 
o The 856 conversion parameter on the REPLACE command is 

utilized to indicate that the 64 bit oriented NQS/VE file is 

to be transferred to the A170 without truncation of data. 56 

C180 data bits are stored in each 60 bit A170 word, 
o The 856 conversion parameter on the GET command is utilized to 

indicate that an A170 file with 56 C180 data bits per 60 bit 

A17Q word are to be transferred to NOS/VE as a 64 bit oriented 

NQS/VE file. 
o REPLACE can no* be used to replace an existing A170 file 
o GET and REPLACE now allow specification of alternate user 

names, 
o Parameters to programs must be delimited by quote marks. 
o Files routed from 170 must contain valid 6/12 ASCII data. No 

previous kludges i% for _) are supported. 

1.7.1,5.1 CREATE OBJECT LIBRARY ON NQS/VE AND SAVE IT ON A170 NQS 
Notes 

o CLG0170 is A170 permanent file name for file containing object 

text (in CI data mapping) for modules to be included in the 

I i br ary. 

o CITEXT180 is NQS/VE local file name for file containing object 

text (in CI data mapping) for modules to be included in the 

I i brar y. 

o IITEXT130 is NOS/VE local file name for file containing object 

text (in II data mapping) for modules to be included in the 

library. 
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1.7.1.5.1 CREATE OBJECT LIBRARY ON NQS/VE AND SAVE IT ON A170 NQS 



o LI8RARY130 is NOS/VE local file name for the library being 

created, 
o ILI8170 is A170 permanent file name for file containing the 

I i br ar y.i 

NQS/VE Job Commands 

LIU, US£R*< jln,N VE) ,? ASS WORD* j I mx, ACCOUNT* not used, PRO J£CT*notused 

GET,citextl80,c!g017Q,,,NVE,B?>0 

EXECUTE,, »ci text 13 0, i itextlSO 1 ,,, CITQI I 

EXECUTE, ,,,,C0L 

ADD, QBJECT_FILE*ii textlSO 

GENERATE, LIBRARY** ibr aryl80 

QUIT 

REPLACE, I ibr ary 180, i I ibl70,, ,NVE,8 56 

1.7.1.5.2 iGDIFY A PREVIOUSLY SAVED 03JECT LIBRARY 

Notes 

o ILIB170 is A170 permanent file name for file containg the old 

I i brary 

o LI8RARY130 is NQS/VE local file name for file containing the 

old library 

o CHQD17Q is A170 permanent file name for file containing CI 

object text for the new module 

o NEWCIMQDULE is NQS/VE local file name for file containing CI 

object text for the new module 

o NEWIIMODULE is NQS/VE local file name for file containing II 

object text for the new module 

o NEWLIBRARY is NQS/VE local file name for the library being 

created 
NLI3170 is A170 local file name for new library 

NQS/VE Job Commands 

LIU,USR*( jl n, N VE ), PASS WORD* j I rax, ACCQUNT^no tused, PRQJECT*not used 

GET, I ibr ary 18 0, ili bl70, , ,NVE,B56 

G£T,newcimodule,cmodl70,,,NV£,8 60 

EXECUTE,, f new ci module, new i imodule , ,,,CITOII 

EXECUTE,, ,,,C0L 

ADD, I i brary*! i brar yl8 

REPLACE,OBJ£CT_FIL£*newii!Hodule 

GENERATE, LI8RARY*newi ibrary 

QUIT 

REPLACE, new I i brary, n I i bl70,,,NV£, 3 56 

QUIT 

RE PL ACE, new I i brary, n I ibl70, , ,NV£, B5 6 
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1.7.1.5,3 USAGE OF NOS/VE LOADER 

LIMITATIONS 

The file(s) specified by the FILE parameter on the EXECUTE 
command may not be object library files. 

The program option PRESET has no effect since the file system 
does not yet support presetting. 

PROCESS 

Create an object text file by compiling a program in real state. 
Then perform the following steps in virtual state? 

Use the SET. 08 JECT.LIST command to specify necessary 
I ibr ar ies« 

— Acquire any necessary libraries {which are ga£ quoted in text 
embedded directives) by either* 

o Creating the library file via the object library generator 

or 
o Staging the library file from real state to vitual state 

using the GET command (with 856 conversion mode 

spec i f i ed). 

Stage the object text file from real state to virtual state 
using the GET command {with B60 conversion mode specified). 

- Convert the object text file from the CI data mapping to II 
data mapping by executing the CITQII utility. 

Load and execute the program via the EXECUTE command. 

Stage the loadmap from virtual state to real state {for 
printing) by using either! 

o The REPLACE command {with A6 conversion mode specified) if 
running on the simulator. 

or 
o The JMROUTE command if running on the hardware. 

EXAMPLES 

The following is an example command sequence for executing a 
program not requiring any libraries for loading? 

Assumptions? all modules to be loaded are contained on the {real 
state) permanent file •citxtrs*. 
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LINK_USER*USER=( jln*N VE)* PASSWORD* jinx*.. 
ACCOUNT- n ot used* PR OJECT»not used 
GET*ci txtvs*ci txtr s** »NV£* 860 
EXECUTE** *citxtvs*t i text « * * *CITOII 
EXECUTE* i i text* * progr an par ameters* 
JNRQUTE* not used *L0AQ!1AP* PR* REMOTE 

A NOS/VE library containing the CY8IL runtime procedures can be 
obtained via the following: 

LINK_USER*JS£R*( jln*NV£>* PASSWORD* jinx* ACC0UNT*not used*.. 

PROJ£CT»notused 

GET* CY 8 IL 13* C YB I IL 8* * OE VI *NV£* 3 56 



The following is an example command sequence 
program requiring libraries for loadings 



for executing a 



Assumptions*' the (real state) permanent file 'citxtrs* contains 
object text generated by the CYBIL CI compiler* The compiler 
modules reference procedures contained on the user library 
•ray'lib* and the CYBIL 'run— tine library* These libraries have 
been generated in virtual state and saved in real state. 

LIN<_USER*USER«( jln*NVE)* PASS WORD* jinx*.. 
ACCOUNT* not used* PROJECT*no tused 
G£T*CYBILI8*CY8ILI8***D£V1*NV£*8 56 
GET* my li b*myl ib***NV£*856 
SET_33J£CT_LIST*ADD»mylib 

SET. PROGR AH. OPTIONS *MAP_OPTIONS»( 8*E *X*S ) 
GET* ci txtvs*ci txtr s***NVE* 860 
EXECUTE** »citxtvs*i itext»***CITOII 
EXECUTE* i i text* • pro gram parameters* 
JMR0UT£*notused*L0ADf1AP*PR*R£M0T£ 

1.7.1.5.4 DIFFERENCES BETWEEN PHASE C (BUILD fi) AND PHASE A/B (BUI 



Notes! 

1) The 'status 1 column indicates whether the command/procedure 
is unchanged from Phase A/B* modified from Phase A/B or not 
available in Phase A/8 (a£M in Phase C). 

2) Footnotes are numbered within each section. 

3) The following summarizes the condition code ranges currently 
assigned to NVE. 



Common Modules 
Common Code Generator 



9*000 - 9*999 
8*000 - 8*999 
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1,0 DUAL STATE NQS/VE DEAOSTART 

1.7»U5.4 DIFFERENCES 8ETWEEM PHASE C {BUILD M) AND PHASE A/B C 8UI 













Product 




Condi t i an 


Code 


Identi f i er 


Product Name 




1 


— 


159j 


► 999 


Reserved 




160j 


► 000 


— 


169j 


999 


AH 


Basic Access Methods 


170j 


► 000 


• 


179j 


► 999 


CL 


Command Language 


130) 


000 


- 


189j 


► 999 


JM 


Job Management 


190j 


► 000 


- 


199 1 


► 999 


LL 


Loader 


200) 


► 000 


.- 


209j 


► 999 


MM 


Memory Management 


210j 


► 000 


— 


219) 


► 999 


D8 


Operating System 


220) 


► 000 


- 


229j 


► 999 


PF 


Permanent File Management 


230j 


► 000 


- 


239j 


► 999 


PH 


Program Management 


240) 


► 000 


- 


249, 


► 999 


RM 


Resource Management 


250) 


► 000 


_ 


259) 


► 999 


OF 


Operator Faci 1 i ty 


260j 


>000 


- 


269i 


► 999 


UA 


User Administrator 


270) 


► 000 


- 


279) 


► 999 


IC 


Interstate Communication 


280) 


► 000 


- 


289j 


► 999 


RH 


Remote Host Facility 


290j 


► 000 


- 


299) 


► 999 


OC 


Object Code Uti 1 ities 


300) 


► 000 


—.. 


309j 


999 


08 


Oeadst art/Recovery 


310) 


► 000 


- 


319j 


► 999 


MS 


Maintenance Services 


320) 


► 000 


- 


329) 


► 999 


Reserved 




500) 


► 000 


- 


509) 


► 999 


AA 


Advanced Access Method 


510, 


► 000 


- 


519, 


► 999 


AG 


ALGOL 


520, 


► 000 


- 


529) 


► 999 


AL 


Assembly Language 


530, 


► 000 


- 


539) 


► 999 


AP 


APL 


540) 


► 000 


- 


549) 


► 999 


3A 


8ASIC 


550) 


► 000 


— 


559 3 


► 999 


CA 


Conversion Aids System 


560j 


► 000 


- 


569) 


► 999 


C8 


COBOL 


570, 


► 000 


- 


579j 


► 999 


CY 


CY8IL 


530, 


► 000 


- 


589) 


► 999 


FT 


FORTRAN 


590j 


► 000 


- 


599) 


► 999 


PA 


PASCAL (Wirth) 


600, 


► 000 


- 


609) 


► 999 


PI 


PL/1 


610, 


► 000 


- 


619, 


► 999 


SM 


Sort Merge 


620, 


► 000 


- 


629, 


► 999 


SY 


SYMPL 



4. Support of 6-12 ASCII from the console (K display) causes 
the following changes* 



I!*£11I- 



I&M$UI£a-IO- 



I&EUI- 



I£MUAI£a_IQ 



/l 
/2 
/3 
/4 
/5 
/6 
/7 
/8 
/9 
/O 



n 

# 
$ 

(reversed /) 

9 
1 

c 
} 

_ (underscore) 



/( 






i 




/) 






1 




/ + 






> 




/- 






< 




f* 






* 




/* 






i 


(single quote) 


// 






/ 




/» 






: 




/A 


to 


tl 


a 


- z ( I o*er case) 
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1*0 DUAL STATE NOS/VE DEAI3START 

1.7,1.5.4 DIFFERENCES BETWEEN PHASE C (BUILD «) AND PHASE A/8 { BUI 

(The major incompatibilities with earlier systems are for 
characters for ; and *. To get a semicolon* type /6> to get 
a • (single quote)* type /* 

example 

ex uutl /* bulk ?/* /6 tstatus 

is 

ex uutl •bulk 1 j tstatus 

1.7.1.5.4.1 e&as£_£_-_£flfflfflaiid_£unst;iflii& 



Eynfiiian. 


1U. 


$MQD 


new 


$CHAR 


new 


SCIOCK 


new 


$DATE 


new 


SFNAHE 


new 


SINTEGER 


new 


SNAliE 


new 


$0R0 


new 


$REAL 


new 


$STRING 


new 


$STRL£N 


new 


SSTRREP 


new 


SSUBSTR 


new 


%TIHE 


new 


$VAR 


new 


$SP£CIF*I£0 


new 


$SET_C0UNT 


new 


SVALJE.COUNT 


new 


SRANGE 


new 


SQEBUG.flODE.ON 


new 


$PARAMET£R_LIST 


new 


$PARAMETER 


new 



1.7.1.5.4.2 £l2as.£_Q_ = _SJtSie.i - AfififiSSl.£ai!aJQili 

Caiiands- Stilus 

Link. User Phi unchanged 

1.7.1.5.4.3 £Hasfi-£-=-&fiSflucfift-Hjaaii5fflfiai 
Qaiiaad. iialua 

REQUEST. TERMINAL NQS- *1 

*1 The R£QUEST_T£RMINAL command does not properly assign a file 
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1,0 DUAL STATE NOS/VE DEADSTART 
1.7.1,5,4.3 Phase C -■ Resource Management 



to a terminal, A RMPSREQUEST .TERMINAL call issued from the 
same task that accesses the terminal via 3AM must be used to 
assign a file to a terminal device. 

Fiies assigned to a terminal device can be accessed via the 
following 8 AH requests* 

o AMPIOPEN 

o AMP$G£T_N£XT 

o AMPSGET.DIRECT 

o AMPSGET. PARTIAL 

o AMPSPUT.NEXT 

o AMP$PUT_DIRECT 

o AMP$PUT_PARTIAL 

o AMPSFLUSH 

o ANPtCLOSE 

AH terminal attributes can be specified on the 

RMP$R£QUEST_TERMXNAL call but only the fol losing are 
operati ona I s 

o auto.input 

o f ormat.ef fectors 

o transparent. mode 

o pront.fi I e 

o prorapt.str i ng 

1.7.1.5.4.4 Etiass.C---EiIa-.llaiiaasie.fli 
CanaQil- Status. 

FILE new 

COPY new 

DUMP. FILE new 

COMPARE new 

1.7.1.5.4.5 £uaifi-d-z-.£fitiaa£at-£ils.aaaaasa&at 

^AflUBAQi. Status 

HCS GET unchanged 

HCS REPLACE unchanged 

DEFINE unchanged 

ATTACH unchanged 

PURGE unchanged 

CHANGE unchanged 

PERMIT unchanged 

DELETE.PERNIT unchanged 

DEFINE. CATALOG unchanged 

PURGEJTATALOG unchanged 
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1.0 DUAL STATE NQS/VE DEADSTART 

1.7*1.5.4*5 Phase C - Permanent File Banagement 



DELETE. CATALOG. PERMIT new 
PERMIT. CATALOG new 

iLammaiiiJ. Status 

PROC/PROCENQ new - *5 

SET.COiMAND.LIST new 

DISPLAY.COHMANQ.LIST new 

REPEAT/UNTIL new 

WHILE/yHILEND new 

DECLARE. VARIABLE unchanged 

REHOVE.VARIABLE unchanged 

8L0CK/8L0CKEH0 new 

LOOP/LaOPEND new 

FOR/FORSNQ new 

IF/ELSE IF /ELSE /IFEND new 

CYCLE new 

EXIT new 

INCLUDE *5 

COLLECT. TEXT *4 

DISPLAY.VALUE unchanged 

EXIT.PR3C new 

ACCEPT unchanged 

DO new 

HCS deleted - *1 

SCL deleted - *1 

change HCS variable modified - *2 

display HCS variable modified - *3 

*1 The SCL interpreter will now be in control to process 
commands when a job is initiated* HCS commands will be 
automatically passed to the HCS command interpreter. 

When SCL "comes up w in a job it displays a banner contaning 
the OS name* date and time. The value of these commands are 
controlled by integration. 

*2 The nea form of this commands is as follows? 

LNS variable name * new. value 

*3 The new form of this command is as follows* 

LNS var i ab I e.name 

** For some time now the default value for the col I ect_tex t 
command , s UNTIL parameter has been { ) rather than ** as 
described in the ERS» This was because it was not possible 
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1.0 DUAL STATE N05/VE OEADSTART 

1.7.1.5.4.6 Phase C - SCI Statements and Procedures 



to enter from the console Con the S2) a line to be 
interpreted on the 180 side that began with an asterisk. 

Since this problem was alleviated in build L the col I ect_text 
command now defaults the UNTIL parameter to **. 

*5 It is now possible to initiate the asynchronous execution of 

tasks within an SCL PR3C or file of INCLUDEd commands and 

have processing of the PROC or file of commands return 

control before the asynchronous tasks have finished. 

1.7,1.5.^.7 £Uass-a.--aiii2£t-k.aiie..iiaiatanaafis 

Cain od_ Siaiys. 

CREATE.QSJECT.LIBRARY unchanged 

DISPLAY.LISRARY unchanged 

SELECT.DI SPLAY .LEVEL unchanged 

ADO unchanged 

REPLACE unchanged 

COMBINE unchanged 

CREATE. H3DULE new 

BIND.MQDJLE new 

DELETE unchanged 

CHANGE unchanged 

SATISFY new 

REORDER unchanged 

GENERATE unchanged 

QUIT unchanged 

CI to II Conversion unchanged 

DEFINE.PROGRAN new 

1.7.1.5.4.8 Ea^£e_£_r_y£a£-££r.Y.isss 
Caiiaad- Status 

0ISPLAY.LOG new — *1 

HCS ZDIS deleted 

HCS FMQAYFIL deleted 

*1 NOS/VE now creates global logs and allows ASCII logs to be 
di spi ayed. 

The system log can be displayed at the console via the 
following command: 

EXECUTE* »»#>SDZ$#TASK_NAM£«taskl 

A job log can be displayed at the console via the following 

command * 
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1.0 DUAL STATE NOS/VE DEADSTART 
1.7*1. 5. 4.8 Phase C — User ' Services 



EXECUTE* »» . «ZDIS. TASK. NAME*task2 

The following differences exist between the build M 
DISPLAf.LOG and the description in the 9/26/80 NOS/VE command 
i nt erface ERS? 

o upon * <l ocal.fi le_.fi an e> instead of output * 

<ft I e. refer ence> 

o type * <systetnj sys * job> instead of type * 

<sy stem' account? engineer ing J 
stati sti cs \ job J job.stat istic> 

l . 7 • l . 5 . 4 . 9 Euase..£_ := _£n e.-£autiaa 

kamiand- Siaiua 

HCS JMROUTE *i 

*1 JMROUTE of the LQADMAP is no longer required. The LOADMAP 
will appear on the standard output file by default. 

1.7. 1.5. 4. io £has.2_£_z-E£ aataa-ixsfiuiiaa 

Canaan ilatiis 

SET.OBJECT.LIST unchanged 

SET.PR3SRAM.0PT IONS *1 

DISPLAY.PR0GR4M new 

EXECUTE new - *2 

"name call" new 

HCS EXECUTE *3 

Library Loader unchanged 

PUSH.DE8UG.M0DE unchanged 

P0P.DE8UG.M0DE unchanged 

SET.DESUG.MODE unchanged 

SET.DE3UG.RING new 

TSTATUS deleted 

TMTERM deleted 

*1 All parameters on SET. PROGRAM. OPTIONS are now supported 

*2 Programs previously loaded by the NOS/VE loader via the HCS 

EXECUTE must now utilize the SCL EXECUTE* The parameter 

passing mechanism is different. The template for a NOS/VE 
program declaration is the following* 

PROGRAM xxx ( par ameter 5 pmt$pr ogr am. par ameter s$ VAR 

status* ost$status) 
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1.0 DUAL STATE NOS/VE OEAOSTART 
1*7.1.5.4.10 Phase C - Program Execution 



where pmtSprogr am_par ameter s 
SEQf*). 



Is defied in deck PMDPARM to be 



*3 



In general the parent and child tasks roust have some 
convention regarding the contents of the sequence* If the 
parent task is SCL (as will be the case when the SCL command 
EXECUTE is processed) then the contents of the sequence is by 
convention of types 



clt$parameter_H st_con tents 



The DEBUG option on the 
supported* DE-3UG mode must 
SET.DESUG.HOQE. 



HCS EXECUTE 
be activated 



command 
vi a the 



is no I onger 
SCL command 



The NOS/VE loader can no longer be activated by the HCS 

command EXECUTE. The SCL command EXECUTE must be used to 

load programs residing on object fies (via the NOS/VE 
loader). 



The HCS command 
supported. HCS 
program library 
procedures whi ch 



EX (also known as EXEC) is no longer 
"Programs" previosly loaded into the HCS 

must now be implemented as CXDCL,#GAT£3 

are bult on the library XLJBBB. 



Existing HCS programs have been converted and run from the 



XLJBBB library. The following list shows the NQSVE 
corresponding to the previous HCS commands. 



commands 



ol d form 

EX RHINPUT,,A 

EX RH0JTQ8,,A 

EX CITOII «param» 

EX COL 

EX OBJLIST «param» 

EX IFEXECA 



new form 

EXECUTE..* ,,RHP$ INPUT, TASK.NAME* A 
EXECUTE,,,,,RHP$OUTPUT»TASK_NAM£*B 
EXECUTE,, «param«,,, CITOII 
EXECUTE, ,,,,C0L 
EX£CUT£,,*param«.,, OBJLIST 
EXECUTE,,,,, IFEX EC, TASK_NAME»C 



1.7.1.5.4.11 PJiase-SL-z-dakJlaaaasisaJ; 

£ajBJBand- £iaius 

SUBMIT new 

DISPLAY.JOB^STATUS new 

DRQP.J38 new 

PRINT new 

DR0P..FILE new 

DISPLAY_PRINT_STATUS new 

HCS JNEXIT *1 

HCS JM9RQP *2 
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1.0 DUAL STATE NOS/VE DEADSTART 
1.7.1.5.4.11 Phase C — Job Management 



*1 JMEXIT is no longer required to terminate a batch job. It is 
required to switch an interactive user back to A170 NOS. 
{The SCL command LOGOUT can also be used.) 

*2 JNDROP of an executing job will no longer work* The SCL 
DROP. JOB command must be used. 

1.7.1.5.4.12 £fcaaS_£-:=-kafflaaad_£LflfiaSSifla 

£L<2£fiilsic&. Status 

CLPSS CAM.P ARAM _L 1ST unchanged 

CLPSTE ST. PARAMETER unchanged 

CLPSGET.KEYWORD unchanged 

CLP$GET_S£T_COUNT unchanged 

CLPSGET. VALUE. COUNT unchanged 

CLPSTEST. RANGE unchanged 

CLPSGET. VALUE unchanged 

CLPSDECLARE.VARIABLE unchanged 

CLPSREMOVE. VARIABLE unchanged 

CLPSREAO. VARIABLE unchanged 

CLP$ WRITE. VARIABLE unchanged 

CLPSSCAN.COMMANO.FILE unchanged 

CLP$£N0_SCAN.C0MM AND. FILE unchanged 

CLPSSCAN.COMMAND.LINE unchanged 

CLPSPUSH/POP COMMAND LIST new 

1.7.1.5.4.13 £basa-£-z-!lfisaiflfi-fifiafi£ai2£ 
£LAfifixlutfi- ££a£iis 

OSP$FORMAT.M£SSAGE unchanged 

OS P$SET_STATUS. ABNORMAL unchanged 

OSP$APl»iEMD.STATUS .PARAMETER unchanged 

1.7.1.5.4.14 £tusa_C-=..Qfiiiififi-flaaaaeasat 
£tflfiSiJiiL.a- SLatua 

RMPSREQUEST.MASS. STORAGE new 

RMPSREQUEST.TERMINAL ? 

1.7.1.5.4.15 fiiiass-k-r-aiisiisdLE iis Jiaaaasaaai 
ELasfiduta. iiaiiis 

JMPSRQUTE unchanged 

JMP$QSTATUS.TERMINAL.FULL new 

JMPIQSTATUS.FAMILY.FULL unchanged 
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1,0 DUAL STATE NOS/VE DEAOSTART 

1.7.1.5.4*15 Phase C - Queued File Management 



J$P$QSTATUS.FIL£_FULL new 

JHP$QCOUNT. TERMINAL new 

JiP$QC3UMT.FANILY unchanged 

JMP$DROP.QFU£ unchanged 

JMPSDItfERT.TERHINAL new 

J HPSDItfERT. FAMILY unchanged 

JMPSDIVERT.QFILE new 

JIPSALTER.QFILE unchanged 

1.7. 1.5. 4.16 £liai£-£-=«££aatai-£xfiauiiaa 

En^afiilyjia-. Status. 

PMP$EXIT new 

PMPSEXECUTE new 

PMP$T£R!1INATE new 

PMP$Atf A I T.TAS<_ TERMINATION new 

PMPSMODULE. TABLE. ADDRESS unchanged 

PNP$ENTRY.POINT.T ABLE. ADDRESS unchanged 

PMP $PUS H.J aB.DEBUG.MQDE unchanged 

PMPSPQP.jaB.DEBUG.MODE unchanged 

PMP$SET.J0B.DE8UG.!10DE unchanged 

PMPSiOB.DEBUG.MQDE.ON unchanged 

PMP$PUSH.TASK.DEBUG.MOD£ unchanged 

P<MP$S£T.TASK.D£BUG.MODE unchanged 

PMP$TASK.DEBUG.MODE.ON unchanged 

PMPSSET. DEBUG. RING new 

PMPSDE3UG.RING new 

PMPSCHANGE.DEBUG.LIBRARY.LIST new 

PMPSPQP.TASK.DEBUG.MODE unchanged 

1.7. i« 5. 4 .17 E'bass_£_r-£tfliitajn-£flmaiiQifiatiiiQ 

PnassjJaiie.. Status 

QSPSAWAIT.ACTIVITY.COMPLETIQN new 

PMPSDEFINE. QUEUE unchanged 

PMP$R£MQV£. QUEUE unchanged 

PMPSCONNECT.QUEUE unchanged 

PMP$D IS CONNECT. QUEUE unchanged 

PMP SSE^D.TQ.QUEUE unchanged 

PMPSRECEIVE.FROH.QUEUE unchanged 

PMPSSTATUS. QUEUE unchanged 

PMP SSTATJS. QUEUES. DEFINED unchanged 

PMPiGET.QUEUE.LIMITS unchanged 

i.7, 1.5.4.18 £&as£-£-r-£aadi.iian-££a££S£in2 

£C £&&dll£.£ - it atilS. 
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1.0 DUAL STATE NOS/VE DEAOSTART 

1.7, 1.5.4. 18 Phase C - Condition Processing 



PHP$ESTA8LISH.C0N0tTI0N.HANQLER unchanged 

PMPSD IS ESTABi. I SH.COND. HANDLER unchanged 

PHP SCAUSE.COND I TI ON unchanged 

PMPSCONTINUE.TO.CAUSE unchanged 

PMPSTES T.CONDI TI0N.HAN9LER unchanged 

PMPSVALIDATE.PREVIQliS. SAVE. AREA new 

PMPSSET.EXECUTI ON. INTERVAL new 

PNPSESTABLISH.DEBUG.CFF new 

1.7. 1,5.4.1 9 enai£»£-.=-E£sa£aa-istti£as 



PNP$GET.TIf1£ 

PflPSGET.MICROSECQND.CLOCK 

PflPSGET.TASK.CP.TIME 

PHPSGET.OATE 

PHPSGET.JSER.IDENTIFICATQN 

PHPSGET.ACCOUNT.PRGJECT 

PHP$G£T.JOB.NAME 

PfiP$GET.J08.I0 

PHPSGET.JOB.HODE 

PfiPSGET.PROGRAfl 

PHPSGET.TASK.ID 

?n?%n an age. sense. switches 

PNPSGET.DS. VERSION 

PMPSGET.PR0CESS0R.ATTRI3UTES 

PMP $0£FlNj£.DE8liG_ENTRY 

PMPSGET.DEBUG.ENTRY 

PHPSM0DIFY.DE3UG.ENTRY 

PMPSRENQVE.DE3UG.ENTRY 

1.7.1.5.4.2 Pfcaia-Cz-Lsaaiaa 

£C2S£di!l£- 

PMPSLOG 

P1PSL03. ASCII 

PMPSDISABLE.ATTACHEs.TQ.LOG 

PliPSENA8LE.ATTACHES.T0.LOG 

PMPSGET.L0G.C3NTR0L 

PHPSTERNINATE.LOG 



unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

new 

new 

new 

new 

new 

new 

new 

new 

unchanged 

new 

new 

new 

new 



*1 

new 

new 

new 

n ew 

new 



*1 logs are now global 

1. 7.1. 5. 4. 21 EbJSfi_£..r_EiifiJUlUflfilftQ* 

Etaasduns. iiaiiis 

Sequential Access *1 
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1.0 DUAL STATE NOS/VE DEADSTART 
1.7.1.5. 4.21 Phase C - File Management 



8y te.Addressab I e Access unchanged 

Record Access *1 

Segment Access ? 

^-System Specified unchanged 

W_User Specified new 

li^System Specified unchanged 

U.User Specified new 

F_ System Specified unchanged 

F_User Specified new 

ANP$DESCRIBE_N£W_FILE unchanged 

AMPSFILE unchanged 

AMP$GET_F I IE. ATTRIBUTES unchanged 

AMPIFETCH unchanged 

AMPSSTORE unchanged 

AMPSCOPY.FILE new 

AMP$R£NAM£ new 

AHP$RETURM_LOCAL_FILE new 

AHPSQPEN unchanged 

AHPSCLOSE unchanged 

AHP$F£TCH_ACCESS_INFORMATIQN unchanged 

AHPSSKIP *4 

AMPSRE^IND *2 

A!iP$WRITE.ENO_PARTITiaN new 

ANP$GET_MSXT *1» *5 

AHP$G£T_DIRECT unchanged (?) 

AHPSGET. PARTIAL *1, *6 

Af1P$GET_PARTIALJ)IRECT unchanged (?) 

AHP$PUT_N£XT *1 

AMPSPUT.DIRECT unchanged (?) 

AMPSPUT.PARTIAL *1, *3 

AHP$PUT_PARTIAL_DIRECT unchanged (?) 

AMP$SE£K_ DIRECT unchanged (?) 

AMP$GET_SEGMENT_ POINTER unchanged <?) 

AMP$S£T_SEGMEN|T_Eai unchanged (?) 

AMP$SET_SEGMENJT_ POSITION unchanged (?) 

AMP$SET_LQCAL_NAHE_ABN3RMAL new 

AMP $S ET_F I L£_IN STANCE. ABNORMAL new 

AMP$ACC£SS_M£THOD new 

AMP$FETCH_FAP_POINTER new 

AMP$ST3RE_FAP_P0INTER unchanged (?) 

*1 user specified blocking is now supported 

*2 AMP$R£tfIND 

The WAIT parameter on the procedure cat I is not supported. 

*3 AMPSPUT. PARTIAL 

PUT. PARTIAL with the TERM. OPTION * AMPCSSTART does najfc start 
a new record. 
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1.0 DUAL STATE NQS/VE DEAOSTART 
1.7.1.5.4.21 Phase C — File Hanagement 



*4 AMPSSKIP 

If the number of units to skip * and the file is positioned 
mid-unit the file will reaain positioned mid-unit* 

*5 AMP$G£T_N£XT 

A G£T_N£XT with a worki ng_stor age length » will return an 
undefined fife position. A request of zero length is invalid 
and will result in abnormal termination in later builds. 

*6 A?1P$G£T_PARTIAL 

A GET^PARTIAL of record type * undefined never returns file 
position of en d-of -record. 

1.7.1.5.4.22 £ha£e-£---E££fflaQ£a£_Eii£_iiaa.aa£isai 
££fi££4lli:£- Status. 

PFP$DEF»IMH 

PFPSATTACH 

PFPSPURGE 

PFPSCHAMGE 

PFP$P£RNIT 

PFPSDELETE.PERHIT 

PFP$0£FIN£. CATALOG 

PFPSPURGE. CATALOG 

PFP$PERHIT_ CATALOG 

PFP$DELET£_CATALQG_PER1IT 

*1 - Suild li Permanent File Program Interface Deficiencies 

1. GET»SAV£ and REPLACE are not implemented <non-R2 features). 

2. Since no validation facility exist at Build M* there is no 
official way for master catalogs to be created* The system 
job does* however* create a master catalog for itself. 
Therefore the system job and other jobs with the same family 
name and user name (familyl* userl) can perform 180 permanent 
file oper ati ons. 

3. Permanent files on the **180 side" are only permanent until a 
NQS/VE deadstart. 

4. Usage_sel ecti ons and shar e_sel ecti ons may be specified on 
the ATTACH request but they will not be honored. Files will 
never appear busy and hence exclusive access is not 
possi bl e. 

5* ATTACH returns an existing local file rather than producing 
an error status. 



unchanged 


- 


*1 


unchanged 


_ 


*1 


unchanged 


— 


*1 


unchanged 


_ 


*1 


unchanged 


- 


*1 


unchanged 


- 


n 


unchanged 


- 


*i 


unchanged 


- 


*i 


unchanged 


— 


*i 


unchanged 
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*i 
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1.0 DUAL STATE NOS/VE DEADSTART 

1*7.1*5*4*22 Phase C - Permanent File Management 



6* DEFINE makes an existing local file permanent rattier than 
producing an error status* 

7* It is possible to create both a catalog and a file with the 
same name at a particular level of the catalog tree* 

8. The WAIT parameter for ATTACH is always treated as if 
PFC$NO.WAIT is specified, 

9, Blank names in the GROUP parameter produce an error status* 

10* Passwords are not validated for ATTACH* PURGE or CHANGE* 

11* Permanent files are n&y/er purged because a retention period 
has expired* 

1.7*1*5*4.23 £bJi2.Q..r _He.i2Ly.-ilaaafl£ilfial; 

MNP$ADv"ISE.IN unchanged 

i1MP$ADVISE.0UT unchanged 

Mf1P$ADVIS£.aUT.IN unchanged 

MMPSWRITE. MODIFIED. PAGES unchanged 

MflPSC RE ATE. SEGMENT unchanged 

MMP$DELETE.SEGMENT unchanged 

MMPSOPEN.SEGMSNT unchanged 

MMP$C LOSE .SEGMENT unchanged 

MMPSSYS TEM. CRE ATE .SE GHENT unchanged 

MMPSSYS TEM. DELETE. SEGMENT unchanged 

MMP$STQRE_SEGMENT.ATTRI8UTES unchanged 

MMP$SYSTEM.DEL£TE.ALL unchanged 

MMP$FETCH.SEGMENT. ATTRIBUTES unchanged 

MM P$ VERIFY. ACCESS unchanged 

MMPSFREE unchanged 

MMPSSTQRE.SEGMENT.ATTRIBUTES unchanged 

MMPSLOCK. PAGES *1 

MMP$UNLOCK. PAGES *1 

MM PSFETCH.PVA. UNWRITTEN. PAGES *1 

*1 stubs have been replaced with code to implement these 
procedures 

1.7.1*5.5 BAM BUILD J DEVIATION FROM ER S 

o d,j£.2_&£luu*£ul£s 

Partition delimiters are neither generated nor recognized 

o aa££.£i:2££JiU££& 

amp$descr i be.new.fi I e 
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1.0 DUAL STATE NOS/VE OEAOSTART 
1.7.1.5.5 SAN BUILD J DEVIATION FROM £RS 



As opposed to the £RS# this request is processed each time a 
file is opened regardless of whether the file is new or old. 

ampSfile 

This request can only be issued once per file with 
predictable results. If a second amp$file is issued it will 
overwrite any attributes supplied via ampldescri be_new_f i'l e. 

amp$fetch_access_info 

Recor d_Iength attribute is not returned correctly. 

Transfer. count attribute not returned correctly. 

Fields err or ."count* error.status and r es i dua l_ski p.coun t are 
not defined. A default for these attributes will be 
returned. 

amp$get_segment_poi nter 

Polnter_ki nd field of pointer not always returned correctly. 

amp$get_next 

Will only transfer the first part of a continuation record 

created via amp$put_par ti al . 

amp$get_par t i a t 

If record length is greater than the working storage length* 
the working storage area will be overwritten to accomodate 
the record. 

Parti al_get of F type records is not available. 

amp$r ewin 

The WAIT parameter on the procedure call is not supported. 

FAPs 

Cannot pass control to a FAP whose execution bracket is less 
than 4. 

i.8 asfli-iiEaaaAiiQti 

To create an Express Oeadstart Dump (EDO) tape* 
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1,8 OSDI INFORMATION 



1) Hount scratch tape (ring in) on a 9-track drive. 

2) Push 0/S button. 

3) Select U {utilities) display. 

4) Select E (EDD) display. 

5) Set channel (S2*13). 

6) Set E-CUU (S2»01uu) 

E * equi pment 

C * 1 for 67X drives 
2 for 66X drives 

uu « unit number of the tape drive to be used. 

7) Answer "non zero inhibits rewind" with a CR. 

8) Answer "dump number" with a CR. 

9) Answer "CM/(H8)" with the size of memory you want to dump 
(in megabytes) -6 for build Ii5. 

Notes This display may not appear* depending on the 
version of EDD being used. 

10) Answer "dump control war e" with a CR. 

To create a listing of the EOD tape* 

1) REaUEST,DUMP*NT,D*PE#F»S*i.3»KU*PG»R>VSN*your choice. 

2) GET,DSDI/UN*DEV1. (On S/M 101.) 

or 
G£T>DSDI/JN*DEtfl. <0n S2.) 

3) Create OSDI directives file: 

A L)S0I directive file should include the following* 

IOUNR. 

PR3MR. 

HEMMR. 

PRORF. 

W>f i rst_by te_address* I ast_byte_adress#as i d. (where the 

f ir st_byte_address and I ast_byte_addr ess are hex byte 
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1.0 DUAL STATE NOS/VE DEAOSTART 
1.8 DSOI INFORMATION 



addresses and asid is the asid of the segment to be 
dumped) 

4) Execute DSDls 

RFU60000. 

DSQI*M*0*I**»input directives file". 

5) To run <after the first time)* 
OSOI* I*n. 

(Does not read tape again.) 

6) To run interact i vel y* 

Same as above* except to do W command must first do? 

OUT?UT*LISTFIL, 

71 C170 OSOI information can be found in Chapter 10 of the 
NQS SYSTEM MAINTENANCE Manual. 

A170 OSDI info can be found in document ARH3060 — GIO 
for A170 N0S/S2. 

l.« MAtU&E.IMQEMIiati 
Bringing NAM up. 



1) At the system console enters 
FNC5*7700. 

3. NAM. 

2) If IAF is not up at control point 1* enter 
IAF. 

3) To send messages to all terminals enters 
3. CF0.1SG*ALL* message. 

Bringing NAM down. 

1) At the system console* enters 
3.CF*0.3I*N£. 

2) Turn the teletype by the 2550 off. 
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1.0 DUAL STATE NQS/VE DEADSTART 
1*9 NAMIAF INFORMATION 



3) To bring IAF down enter: 
l.STOP. 



1.10 AUQJiQS-SilUiaiMI! 

Before leaving the machine* it is necessary to bring NOS 

down* If NQS has crashed* a I evel 3 deadstart must be attempted 

{see Section 3*1*3) even if the only reason is to bring NOS 
down* To bring NOS down, do the following! 

1) Enters 

CHE 

The screen will display: 
CHECKPOINT SYSTEM. 
Enters carriage return 

2) Hake sure no mass storage device has a checkpoint rquested. 
To do this* enters E*M. If the display shows there are no 
**C M s in the status field* then ail devices are checkpointed 
and yoj may continue. 

3) Enters 
STEP. 

4) Push deadstart button* 



The following precautions must be taken when running dual 
state with the Interim Memory Link storage move fix (NOS/VE Build 
J6 and associated N0S/A170 System)* 

1) Drop IRHF170* PASSON and all permanent file partner jobs 
before doing *3YEVE (via 2. STOP*) 

2) Oo not rol lout IRHF170* PASSON or permanent file partner jobs 
at any time. 

3) Before doing a CHECKPOINT SYSTEM* drop IRHF170* PASSON and 
all permanent file partner jobs (via 2* STOP*) 

4) If the system crashes a N0S/A170 level 3 deadstart is the 
preferred action* If for some reason yos must do an MCU 
recovery (REC command) do the following* 
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1.0 DUAL STATE NOS/VE DEADSTART 

1.11 INTERIM MEMORY LINK STORAGE HOVE CONSIDERATIONS 



- Clear word 17(8) via* 

99. 
17,0. 
Enter REC on the NCU console. 

- Finish up in A170 only mode (i.e.* do not do an UPHYVEI* 
then do a level 3 deadstart. If you bring up NOS/VE again 
without doing a level 3 deadstart* the results are 
unpr edi ctab I e. 

1.12 &QS£¥£.im&A£IIi£-EA£ILIII-JJE£aAIlWi 

1.12.1 OPERATOR INITIATION 

To bring up the NOS/VE interactive facility do the following: 

1) 8ring up NOS/VE Cbuild N). 

2) Bring up N0S/A170 networks: 

FNC5»7700. (may sometimes be skipped) 

- 3. NAN. 

3) Bring up A170 part of interactive? 

- TAFMVE. CI f not yet done) 

4) When NOS/VE is up* bring up the C130 part of interactive! 

- K.EXECUTE##>##IF£XEC#TASK_NAN£»IFEXEC. 

1.12.2 OPERATOR TERMINATION 

To terminate NOS/VE interactive any of the following may be 

done J 

- 3.CF0.0I#AP*TAF*. (3 is the NAN control point number) 

This is the preferred method. To bring NOS/VE interactive 
back up» you must first do a 3.CF0.EN* AP»TAF. 

3.CFQ.DI>NE. (2 is the NAN control point number) 

This terminates the entire network including IAF>RBF# etc. 
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1*0 DUAL STATE NOS/VE DEAOSTART 
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1.12*3 OTHER OPERATOR CAPABILITIES 

To send a "shutdown warning" to all terminals logged on to TAP 
do: 

3*CF3.I0# AP*TAF* (2 is the NAM control point number) 

- To send a message to all terminals do* 

3.CF 3.1SG* AtL#mesage. C2 is the NAM control point number) 

— PASSON has the ability to record various types of diagnostic 
information. This capability is* controlled via the sense 
switches at the PASSON control point. To turn a sense switch 
on {off) at control point N do* 

N.QNSWX. (N.OFFStfX.) 

Where X is the desired sense switch CI to 6). The PASSON 
default is all sense switches off. It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts to it. The sense switches currently used by 
PASSON are* 

sait£la_JL uss. 

1 Network Trace 

2 PASSON Logic Trace To Dayfile 

3 Memory Link Trace To Dayfile 

1.12.4 INTERACTIVE TERMINAL OPERATION 

1.12.4.1 midaiiaa-IaJUfifiixJiamf 

To access NOS/VE via the interactive facility* your user 
number must be validated to logon to the application named TAF. 
If you get the message 'ILLEGAL APPLICATION* when trying to 
logon* you are probably not validated to access TAF. To correct 
this do the following from the console: 

X.MODVAL. 

KtN. (N is the MODVAL control point number) 
K.U*ccc. (ccc is your user number) 
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K.AP*ALL. 

K.ENO.: 
K.END.i 

If you get the message 'CONNECTION PROHIBITED* it means that 
only one terminal per user number can be logged on to TAF at one 
time. This indicates that someone has changed the network 
configuration - try a different user number until the network 
configuration is changed. 

1.12.4.2 UsiQ-Ia-afliZXE- 

To initially login to NQS/VE via TAF» you must cause the first 
logon attempt to fail. This can be done by responding to the 
"FAMILY* H logon prompt with something like? M A»A#A W . This must 
be done because the system will try to connect the terminal to 
IAF on the first logon attempt no matter what is typed. To 
access TAF do the following on the second "FAMILY* ** prompts 

* user* passwor d*TAF 

You can access TAF from IAF by doing "HELLO* TAF" or by 
answering TAF to the system prompt "APPLICATIONS". 

1.12.4.3 latiiaJl-llSLAilfi 

1) The slash (/) is a prompt to enter a NQS/VE command. Any 
normal NQS/VE command can now be entered. The full ASCII 
character set (lower or upper case and all special characters 
can be used). Commands do not need to be ended with a 
per iod. 

2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate and it*s dayfile (job log) will be returned to the 
A170 for printing. A new NOS/VE Interactive Job can then be 
started by responding to the f APPLICATION s • prompt with TAF. 

3) Terminal breaks (control-T and control-P) now work. It is 
possible to terminate a task or to suspend a task and enter a 
new tasx* to process SCL commands. When a break is entered* 
the options available to the terminal user ares 

R -resume from point of interruption 

T — terminate task 

S - process SCL commands. To resume execution at the point 
of interruption use the HCS command TNEXIT 
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{ temporary J . 
1.12.4.4 iiaS£M£^EL2aLai.ia£2SS-.Ifi«Illfi.IS£lJJ13l 

1) Interactive MQS/VE jobs are able to obtain terminal input 
through the AHP$GET_NEXT or AMPSGET.PARTIAL program interface 
which can be used by both task services and user ring 
programs. Interactive programs which use this interface 
should be able to handle both upper and lower case input in 
order to make them more convenient to use in both 64 and 96 
character set modes. 

2) Interactive NOS/VE jobs can send output to a terminal through 
the CLP$PUT_STND_QUT program interface which can be used by 
both task services and user ring programs. 
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2*0 S2_a£^Jiaa£MI-L4a-£yE£QSI-BX-im£££mQf!i 



What we have established in the lab so far is the following* 

- A 600 tape capacity tape rack for general use f located In near 

proximity to the 67X tape drives)* If your project would 

like to reserve a section of this tape rack* contact Tim or 
myself. 

A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to 
date. (If you have beer% using this cabinet for unauthorized 
storage - beware. We have the key to the lock!) Hore will 
be published about the contents of this cabinet later* and a 
cabinet index will be posted in the lab to help locate where 
things are supposed to be placed within the cabinet* This 
cabinet is currently located against th East wall of the lab* 
is 6 ft. 8 in* tall* gray in color and with sliding door* 

A two-level documentation rack for system documentation 
listings. This contains the current build compilation 

listing interface deck compilation listing (from module named 
QLNOS)* listing of the NOS/VE PPU routines* system link map* 
and various assorted PVE listings* This rack is next to the 
tape and disk cabinet at this time. 

A desk documentation rack for reference manuals and Tom 

HcGee*s collection of **how to* goodies. The objective is to 

have this reference information at arm's length of the 

console* but it is currently on top of the two-level unit by 
the East wall* 

At or near the console is a sma I I notebook containing the NOS 
System Programmer's Instant* NOS Application Programmers 
Instant* and the 180 Instruction codes* 

Feel free to examine and use all of the above materials while in 

the lab. aa.Qfli.csiai£-a£-atiusfi»aax-.a£-lli£5La-iaJtsi:ialsa- Please 

notify Tim McGibbon or Hike Carter of any problems or 
deficiencies of these materials* Leave a note if we are not 
av at 1 able* 
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1.0 Hardware Overview 

1.1 An introduction to CYBER ISO 

1*2 C130 Instant 

1.3 Mode) Independent General Desi gn Speci f I cati on — ARH1700 

2.0 NOS Reference Manuals 

2.1 XEDIT V3.0 - 60*55730 

2.2 IAF VI. User's Guide - 60455260 

2.3 NOS Reference Manual - Vol It 60435400 - Vol 2» 60445300 

2.4 NOS Instant 

2.5 NOS Operators Guide - 60435600 

2.6 NOS Diagnostic Handbook 

2.7 NOS A170 ERS 

2.8 NOS A170 GID - ARH3060 

3.0 NOS/VE Reference Documents 

3»1 Program Interface ERS -■ obtained from Karen Rubey 

3.2 Command Interface ERS - obtained from Karen Rubey 

3.3 NOS/VE User»s Guide — obtained by the following: 
ATTACH, HU3/UN*DAH 

SES. FORMAT I«HUG>L »L IS T #L0C AL# TXTFORM 
SES. PRINT LIST 

3.4 NOS/VE Procedures and Conventions - obtained by 
SEStMAD.LISTPC 

3»5 JFS Oeadstart /180 Operating Procedures 

3.6 Listing of all NOS/VE Modules - obtained by 
SESVDEV1.LISTNVE. See Integration Procedures Notebook 
for detai Is. 
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3.7 Listing of all NOS/VE type declarations - obtained by 
doing* SES >DEV1.LIST.WE M*QINQS. 

3.3 NOS/VE Code Tr ansmi tta I / PL Maintenance Procedures 

See Integration Procedures Notebook. 

3.9 NOS/VE Internal Interface Maintenance Procedures 
1iemo available from S.C. Wood.: 

3.10 Integration Procedures Notebook 
Obtained by* 

Acquire* IPNDQC2/UN»MDC . SES. PRINT* IPND0C2. 

4.0 Tools Reference Documents 

4.1 PASCAL-X Interactive Debugger - ARH3142 

4.2 SES User's Guide - ARH1833 

4.3 PASCAL-X Specification - ARH2298 

4.4 C130 Assembler ERS - ARH1693 

4.5 Simulator ERS - ARH1729 

4.6 VESEi ERS - ARH2591 

4.7 VELIW ERS - ARH2816 

4.8 Simulated I/O ERS - ARH3125 

4.9 Object Code Utilities ERS - ARH2922 

4.10 CY3IL Implementation Dependent Handbook ■- ARH3078 

5.0 Dual State Cookbook 

To acquire additional copies of this document enter? 

ACQUIRE DQCUM£N/UN*SKT512 
SES. FORMAT I-DQCUMEN TXTFORM. 
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